streamlit-nightly 1.44.2.dev20250427__py3-none-any.whl → 1.45.1.dev20250429__py3-none-any.whl

streamlit/auth_util.py

@@ -40,7 +40,7 @@ class AuthCache:
 
     # for set method, we are follow the same signature used in Authlib
     # the expires_in is not used in our case
-    def set(self, key, value, expires_in):
+    def set(self, key, value, expires_in):  # noqa: ARG002
         self.cache[key] = value
 
     def get_dict(self):

streamlit/commands/experimental_query_params.py

@@ -14,8 +14,8 @@
 
 from __future__ import annotations
 
-import urllib.parse as parse
 from typing import Any
+from urllib import parse
 
 from streamlit.errors import StreamlitAPIException
 from streamlit.proto.ForwardMsg_pb2 import ForwardMsg

streamlit/components/v1/custom_component.py

@@ -210,7 +210,7 @@ And if you're using Streamlit Cloud, add "pyarrow" to your requirements.txt."""
                 )
             element.component_instance.id = computed_id
 
-            def deserialize_component(ui_value, widget_id=""):
+            def deserialize_component(ui_value):
                 # ui_value is an object from json, an ArrowTable proto, or a bytearray
                 return ui_value
 

streamlit/config.py

@@ -662,6 +662,20 @@ _create_option(
 
 _create_section("server", "Settings for the Streamlit server")
 
+
+_create_option(
+    "server.folderWatchList",
+    description="""
+        List of folders to watch for changes.
+
+        By default, Streamlit watches for files in the current working directory.
+        Use this parameter to specify additional folders to watch.
+
+        Note: This is a list of absolute paths.
+    """,
+    default_val=[],
+)
+
 _create_option(
     "server.folderWatchBlacklist",
     description="""
@@ -1530,8 +1544,8 @@ def get_config_options(
             if not os.path.exists(filename):
                 continue
 
-            with open(filename, encoding="utf-8") as input:
-                file_contents = input.read()
+            with open(filename, encoding="utf-8") as file:
+                file_contents = file.read()
 
             _update_config_with_toml(file_contents, filename)
 
@@ -1561,8 +1575,8 @@ def _check_conflicts() -> None:
 
     # When using the Node server, we must always connect to 8501 (this is
     # hard-coded in JS). Otherwise, the browser would decide what port to
-    # connect to based on window.location.port, which in dev is going to
-    # be (3000)
+    # connect to based on window.location.port, which in dev is going
+    # to be (3000)
 
     # Import logger locally to prevent circular references
     from streamlit.logger import get_logger

streamlit/delta_generator.py

@@ -423,7 +423,6 @@ class DeltaGenerator(
         delta_type: str,
         element_proto: Message,
         add_rows_metadata: AddRowsMetadata | None = None,
-        user_key: str | None = None,
     ) -> DeltaGenerator:
         """Create NewElement delta, fill it, and enqueue it.
 
@@ -435,8 +434,6 @@ class DeltaGenerator(
             The actual proto in the NewElement type e.g. Alert/Button/Slider
         add_rows_metadata : AddRowsMetadata or None
             Metadata for the add_rows method
-        user_key : str or None
-            A custom key for the element provided by the user.
 
         Returns
         -------

streamlit/deprecation_util.py

@@ -200,7 +200,7 @@ def _create_deprecated_obj_wrapper(obj: TObj, show_warning: Callable[[], Any]) -
 
         @staticmethod
         def _make_magic_function_proxy(name):
-            def proxy(self, *args):
+            def proxy(self, *args):  # noqa: ARG001
                 maybe_show_warning()
                 return getattr(obj, name)
 

streamlit/elements/arrow.py

@@ -160,7 +160,7 @@ class DataframeState(TypedDict, total=False):
 class DataframeSelectionSerde:
     """DataframeSelectionSerde is used to serialize and deserialize the dataframe selection state."""
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> DataframeState:
+    def deserialize(self, ui_value: str | None) -> DataframeState:
         empty_selection_state: DataframeState = {
             "selection": {
                 "rows": [],
@@ -208,14 +208,14 @@ def parse_selection_mode(
         )
 
     parsed_selection_modes = []
-    for selection_mode in selection_mode_set:
-        if selection_mode == "single-row":
+    for mode in selection_mode_set:
+        if mode == "single-row":
             parsed_selection_modes.append(ArrowProto.SelectionMode.SINGLE_ROW)
-        elif selection_mode == "multi-row":
+        elif mode == "multi-row":
             parsed_selection_modes.append(ArrowProto.SelectionMode.MULTI_ROW)
-        elif selection_mode == "single-column":
+        elif mode == "single-column":
             parsed_selection_modes.append(ArrowProto.SelectionMode.SINGLE_COLUMN)
-        elif selection_mode == "multi-column":
+        elif mode == "multi-column":
             parsed_selection_modes.append(ArrowProto.SelectionMode.MULTI_COLUMN)
     return set(parsed_selection_modes)
 

streamlit/elements/code.py

@@ -16,6 +16,7 @@ from __future__ import annotations
 
 from typing import TYPE_CHECKING, cast
 
+from streamlit.elements.lib.layout_utils import WidthWithoutContent, validate_width
 from streamlit.proto.Code_pb2 import Code as CodeProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.string_util import clean_text
@@ -35,6 +36,7 @@ class CodeMixin:
         line_numbers: bool = False,
         wrap_lines: bool = False,
         height: int | None = None,
+        width: WidthWithoutContent = "stretch",
     ) -> DeltaGenerator:
         """Display a code block with optional syntax highlighting.
 
@@ -67,6 +69,11 @@ class CodeMixin:
             its content. Vertical scrolling within the element is enabled when
             the height does not accomodate all lines.
 
+        width : "stretch" or int
+            The width of the code block. This can be either:
+            - "stretch" (default): The code block will stretch to fill the container width
+            - An integer: The code block will have a fixed width in pixels
+
         Examples
         --------
         >>> import streamlit as st
@@ -106,6 +113,14 @@ class CodeMixin:
         code_proto.wrap_lines = wrap_lines
         if height:
             code_proto.height = height
+
+        # Set width configuration
+        validate_width(width)
+        if isinstance(width, int):
+            code_proto.width_config.pixel_width = width
+        else:
+            code_proto.width_config.use_stretch = True
+
         return self.dg._enqueue("code", code_proto)
 
     @property

streamlit/elements/deck_gl_json_chart.py

@@ -91,10 +91,10 @@ def parse_selection_mode(
         )
 
     parsed_selection_modes = []
-    for selection_mode in selection_mode_set:
-        if selection_mode == "single-object":
+    for mode in selection_mode_set:
+        if mode == "single-object":
             parsed_selection_modes.append(PydeckProto.SelectionMode.SINGLE_OBJECT)
-        elif selection_mode == "multi-object":
+        elif mode == "multi-object":
             parsed_selection_modes.append(PydeckProto.SelectionMode.MULTI_OBJECT)
     return set(parsed_selection_modes)
 
@@ -233,7 +233,7 @@ class PydeckState(TypedDict, total=False):
 class PydeckSelectionSerde:
     """PydeckSelectionSerde is used to serialize and deserialize the Pydeck selection state."""
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> PydeckState:
+    def deserialize(self, ui_value: str | None) -> PydeckState:
         empty_selection_state: PydeckState = {
             "selection": {
                 "indices": {},

streamlit/elements/dialog_decorator.py

@@ -97,7 +97,6 @@ def _dialog_decorator(
             # if the dialog should be closed, st.rerun() has to be called
             # (same behavior as with st.fragment)
             _ = non_optional_func(*args, **kwargs)
-            return None
 
         # the fragment decorator has multiple return types so that you can pass
         # arguments to it. Here we know the return type, so we cast

streamlit/elements/doc_string.py

@@ -28,7 +28,7 @@ from streamlit.proto.DocString_pb2 import DocString as DocStringProto
 from streamlit.proto.DocString_pb2 import Member as MemberProto
 from streamlit.runtime.metrics_util import gather_metrics
 from streamlit.runtime.scriptrunner.script_runner import (
-    __file__ as SCRIPTRUNNER_FILENAME,
+    __file__ as SCRIPTRUNNER_FILENAME,  # noqa: N812
 )
 from streamlit.runtime.secrets import Secrets
 from streamlit.string_util import is_mem_address_str
@@ -149,18 +149,14 @@ def _marshall(doc_string_proto: DocStringProto, obj: Any) -> None:
 
 def _get_name(obj):
     # Try to get the fully-qualified name of the object.
-    # For example:
-    #   st.help(bar.Baz(123))
-    #
-    #   The name is bar.Baz
+    # For example: st.help(bar.Baz(123))
+    #    The name is bar.Baz
     name = getattr(obj, "__qualname__", None)
     if name:
         return name
 
     # Try to get the name of the object.
-    # For example:
-    #   st.help(bar.Baz(123))
-    #
+    # For example: st.help(bar.Baz(123))
     #   The name is Baz
     return getattr(obj, "__name__", None)
 
@@ -175,10 +171,6 @@ def _get_signature(obj):
 
     sig = ""
 
-    # TODO: Can we replace below with this?
-    # with contextlib.suppress(ValueError):
-    #     sig = str(inspect.signature(obj))
-
     try:
         sig = str(inspect.signature(obj))
     except ValueError:
@@ -248,20 +240,20 @@ def _get_variable_name_from_code_str(code):
 
     # Example:
     #
-    # tree = Module(
-    #   body=[
-    #     Expr(
-    #       value=Call(
-    #         args=[
-    #           Name(id='the variable name')
-    #         ],
-    #         keywords=[
-    #           ???
-    #         ],
-    #       )
-    #     )
-    #   ]
-    # )
+    # > tree = Module(
+    # >   body=[
+    # >     Expr(
+    # >       value=Call(
+    # >         args=[
+    # >           Name(id='the variable name')
+    # >         ],
+    # >         keywords=[
+    # >           ???
+    # >         ],
+    # >       )
+    # >     )
+    # >   ]
+    # > )
 
     # Check if this is an magic call (i.e. it's not st.help or st.write).
     # If that's the case, just clean it up and return it.

streamlit/elements/image.py

@@ -167,15 +167,14 @@ class ImageMixin:
             elif use_column_width == "never" or use_column_width is False:
                 image_width = WidthBehavior.ORIGINAL
 
-        else:
-            if use_container_width is True:
-                image_width = WidthBehavior.MAX_IMAGE_OR_CONTAINER
-            elif image_width is not None and image_width > 0:
-                # Use the given width. It will be capped on the frontend if it
-                # exceeds the container width.
-                pass
-            elif use_container_width is False:
-                image_width = WidthBehavior.MIN_IMAGE_OR_CONTAINER
+        elif use_container_width is True:
+            image_width = WidthBehavior.MAX_IMAGE_OR_CONTAINER
+        elif image_width is not None and image_width > 0:
+            # Use the given width. It will be capped on the frontend if it
+            # exceeds the container width.
+            pass
+        elif use_container_width is False:
+            image_width = WidthBehavior.MIN_IMAGE_OR_CONTAINER
 
         image_list_proto = ImageListProto()
         marshall_images(

streamlit/elements/lib/built_in_chart_utils.py

@@ -366,8 +366,8 @@ def _infer_vegalite_type(
         return "quantitative"
 
     elif typ == "categorical" and data.cat.ordered:
-        # STREAMLIT MOD: The original code returns a tuple here:
-        # return ("ordinal", data.cat.categories.tolist())
+        # The original code returns a tuple here:
+        # return ("ordinal", data.cat.categories.tolist())  # noqa: ERA001
         # But returning the tuple here isn't compatible with our
         # built-in chart implementation. And it also doesn't seem to be necessary.
         # Altair already extracts the correct sort order somewhere else.
@@ -387,11 +387,11 @@ def _infer_vegalite_type(
         return "temporal"
     else:
         # STREAMLIT MOD: I commented this out since Streamlit doesn't use warnings.warn.
-        # warnings.warn(
-        #     "I don't know how to infer vegalite type from '{}'.  "
-        #     "Defaulting to nominal.".format(typ),
-        #     stacklevel=1,
-        # )
+        # > warnings.warn(
+        # >     "I don't know how to infer vegalite type from '{}'.  "
+        # >     "Defaulting to nominal.".format(typ),
+        # >     stacklevel=1,
+        # > )
         return "nominal"
 
 
@@ -551,7 +551,7 @@ def _melt_data(
         )
 
     # Arrow has problems with object types after melting two different dtypes
-    # pyarrow.lib.ArrowTypeError: "Expected a <TYPE> object, got a object"
+    # > pyarrow.lib.ArrowTypeError: "Expected a <TYPE> object, got a object"
     fixed_df = dataframe_util.fix_arrow_incompatible_column_types(
         melted_df,
         selected_columns=[

streamlit/elements/lib/column_config_utils.py

@@ -188,7 +188,7 @@ def _determine_data_kind_via_arrow(field: pa.Field) -> ColumnDataKind:
 
     # Interval does not seem to work correctly:
     # if pa.types.is_interval(field_type):
-    #     return ColumnDataKind.INTERVAL
+    #     return ColumnDataKind.INTERVAL  # noqa: ERA001
 
     if pa.types.is_binary(field_type):
         return ColumnDataKind.BYTES

streamlit/elements/lib/column_types.py

@@ -12,6 +12,9 @@
 # See the License for the specific language governing permissions and
 # limitations under the License.
 
+# Allow function names with uppercase letters:
+# ruff: noqa: N802
+
 from __future__ import annotations
 
 import datetime

streamlit/elements/lib/image_utils.py

@@ -97,12 +97,12 @@ def _validate_image_format_string(
     - For all other strings, return "PNG" if the image has an alpha channel,
     "GIF" if the image is a GIF, and "JPEG" otherwise.
     """
-    format = format.upper()
-    if format in {"JPEG", "PNG"}:
-        return cast("ImageFormat", format)
+    img_format = format.upper()
+    if img_format in {"JPEG", "PNG"}:
+        return cast("ImageFormat", img_format)
 
     # We are forgiving on the spelling of JPEG
-    if format == "JPG":
+    if img_format == "JPG":
         return "JPEG"
 
     pil_image: PILImage
@@ -122,7 +122,7 @@ def _validate_image_format_string(
     return "JPEG"
 
 
-def _PIL_to_bytes(
+def _pil_to_bytes(
     image: PILImage,
     format: ImageFormat = "JPEG",
     quality: int = 100,
@@ -139,7 +139,7 @@ def _PIL_to_bytes(
     return tmp.getvalue()
 
 
-def _BytesIO_to_bytes(data: io.BytesIO) -> bytes:
+def _bytesio_to_bytes(data: io.BytesIO) -> bytes:
     data.seek(0)
     return data.getvalue()
 
@@ -149,9 +149,9 @@ def _np_array_to_bytes(array: npt.NDArray[Any], output_format: str = "JPEG") ->
     from PIL import Image
 
     img = Image.fromarray(array.astype(np.uint8))
-    format = _validate_image_format_string(img, output_format)
+    img_format = _validate_image_format_string(img, output_format)
 
-    return _PIL_to_bytes(img, format)
+    return _pil_to_bytes(img, img_format)
 
 
 def _verify_np_shape(array: npt.NDArray[Any]) -> npt.NDArray[Any]:
@@ -199,11 +199,11 @@ def _ensure_image_size_and_format(
         # versions. The types don't seem to reflect this, though, hence the type: ignore
         # below.
         pil_image = pil_image.resize((width, new_height), resample=Image.BILINEAR)  # type: ignore[attr-defined]
-        return _PIL_to_bytes(pil_image, format=image_format, quality=90)
+        return _pil_to_bytes(pil_image, format=image_format, quality=90)
 
     if pil_image.format != image_format:
         # We need to reformat the image.
-        return _PIL_to_bytes(pil_image, format=image_format, quality=90)
+        return _pil_to_bytes(pil_image, format=image_format, quality=90)
 
     # No resizing or reformatting necessary - return the original bytes.
     return image_data
@@ -216,16 +216,13 @@ def _clip_image(image: npt.NDArray[Any], clamp: bool) -> npt.NDArray[Any]:
     if issubclass(image.dtype.type, np.floating):
         if clamp:
             data = np.clip(image, 0, 1.0)
-        else:
-            if np.amin(image) < 0.0 or np.amax(image) > 1.0:
-                raise RuntimeError("Data is outside [0.0, 1.0] and clamp is not set.")
+        elif np.amin(image) < 0.0 or np.amax(image) > 1.0:
+            raise RuntimeError("Data is outside [0.0, 1.0] and clamp is not set.")
         data = data * 255
-    else:
-        if clamp:
-            data = np.clip(image, 0, 255)
-        else:
-            if np.amin(image) < 0 or np.amax(image) > 255:
-                raise RuntimeError("Data is outside [0, 255] and clamp is not set.")
+    elif clamp:
+        data = np.clip(image, 0, 255)
+    elif np.amin(image) < 0 or np.amax(image) > 255:
+        raise RuntimeError("Data is outside [0, 255] and clamp is not set.")
     return data
 
 
@@ -301,14 +298,14 @@ def image_to_url(
 
     # PIL Images
     elif isinstance(image, (ImageFile.ImageFile, Image.Image)):
-        format = _validate_image_format_string(image, output_format)
-        image_data = _PIL_to_bytes(image, format)
+        img_format = _validate_image_format_string(image, output_format)
+        image_data = _pil_to_bytes(image, img_format)
 
     # BytesIO
     # Note: This doesn't support SVG. We could convert to png (cairosvg.svg2png)
     # or just decode BytesIO to string and handle that way.
     elif isinstance(image, io.BytesIO):
-        image_data = _BytesIO_to_bytes(image)
+        image_data = _bytesio_to_bytes(image)
 
     # Numpy Arrays (ie opencv)
     elif isinstance(image, np.ndarray):
@@ -430,15 +427,17 @@ def marshall_images(
 
     proto_imgs.width = int(width)
     # Each image in an image list needs to be kept track of at its own coordinates.
-    for coord_suffix, (image, caption) in enumerate(zip(images, captions)):
+    for coord_suffix, (single_image, single_caption) in enumerate(
+        zip(images, captions)
+    ):
         proto_img = proto_imgs.imgs.add()
-        if caption is not None:
-            proto_img.caption = str(caption)
+        if single_caption is not None:
+            proto_img.caption = str(single_caption)
 
         # We use the index of the image in the input image list to identify this image inside
         # MediaFileManager. For this, we just add the index to the image's "coordinates".
         image_id = "%s-%i" % (coordinates, coord_suffix)
 
         proto_img.url = image_to_url(
-            image, width, clamp, channels, output_format, image_id
+            single_image, width, clamp, channels, output_format, image_id
         )

streamlit/elements/lib/pandas_styler_utils.py

@@ -196,13 +196,13 @@ def _pandas_style_to_css(
 
     # In pandas >= 1.1.0
     # translated_style["cellstyle"] has the following shape:
-    # [
-    #   {
-    #       "props": [("color", " black"), ("background-color", "orange"), ("", "")],
-    #       "selectors": ["row0_col0"]
-    #   }
-    #   ...
-    # ]
+    # > [
+    # >   {
+    # >       "props": [("color", " black"), ("background-color", "orange"), ("", "")],
+    # >       "selectors": ["row0_col0"]
+    # >   }
+    # >   ...
+    # > ]
     if style_type == "table_styles":
         cell_selectors = [style["selector"]]
     else:

streamlit/elements/map.py

@@ -20,8 +20,8 @@ import copy
 import json
 from typing import TYPE_CHECKING, Any, Final, cast
 
-import streamlit.elements.deck_gl_json_chart as deck_gl_json_chart
 from streamlit import config, dataframe_util
+from streamlit.elements import deck_gl_json_chart
 from streamlit.elements.lib.color_util import (
     Color,
     IntColorTuple,
@@ -230,7 +230,7 @@ class MapMixin:
         #
         # For reference, this was the docstring for map_style:
         #
-        #   map_style : str or None
+        #   map_style : str, None
         #       One of Mapbox's map style URLs. A full list can be found here:
         #       https://docs.mapbox.com/api/maps/styles/#mapbox-styles
         #

streamlit/elements/plotly_chart.py

@@ -214,7 +214,7 @@ class PlotlyChartSelectionSerde:
     selection state.
     """
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> PlotlyState:
+    def deserialize(self, ui_value: str | None) -> PlotlyState:
         empty_selection_state: PlotlyState = {
             "selection": {
                 "points": [],
@@ -257,12 +257,12 @@ def parse_selection_mode(
         )
 
     parsed_selection_modes = []
-    for selection_mode in selection_mode_set:
-        if selection_mode == "points":
+    for mode in selection_mode_set:
+        if mode == "points":
             parsed_selection_modes.append(PlotlyChartProto.SelectionMode.POINTS)
-        elif selection_mode == "lasso":
+        elif mode == "lasso":
             parsed_selection_modes.append(PlotlyChartProto.SelectionMode.LASSO)
-        elif selection_mode == "box":
+        elif mode == "box":
             parsed_selection_modes.append(PlotlyChartProto.SelectionMode.BOX)
     return set(parsed_selection_modes)
 

streamlit/elements/vega_charts.py

@@ -33,8 +33,8 @@ from typing import (
 
 from typing_extensions import TypeAlias
 
-import streamlit.elements.lib.dicttools as dicttools
 from streamlit import dataframe_util, type_util
+from streamlit.elements.lib import dicttools
 from streamlit.elements.lib.built_in_chart_utils import (
     AddRowsMetadata,
     ChartStackType,
@@ -227,7 +227,7 @@ class VegaLiteStateSerde:
 
     selection_parameters: Sequence[str]
 
-    def deserialize(self, ui_value: str | None, widget_id: str = "") -> VegaLiteState:
+    def deserialize(self, ui_value: str | None) -> VegaLiteState:
         empty_selection_state: VegaLiteState = {
             "selection": AttributeDictionary(
                 # Initialize the select state with empty dictionaries for each selection parameter.
@@ -256,8 +256,8 @@ def _prepare_vega_lite_spec(
     **kwargs,
 ) -> VegaLiteSpec:
     if kwargs:
-        # Support passing in kwargs. Example:
-        #   marshall(proto, {foo: 'bar'}, baz='boz')
+        # Support passing in kwargs.
+        # > marshall(proto, {foo: 'bar'}, baz='boz')
         # Merge spec with unflattened kwargs, where kwargs take precedence.
         # This only works for string keys, but kwarg keys are strings anyways.
         spec = dict(spec, **dicttools.unflatten(kwargs, _CHANNELS))
@@ -313,10 +313,10 @@ def _marshall_chart_data(
         del spec["datasets"]
 
     # Pull data out of spec dict when it's in a top-level 'data' key:
-    #   {data: df}
-    #   {data: {values: df, ...}}
-    #   {data: {url: 'url'}}
-    #   {data: {name: 'foo'}}
+    # > {data: df}
+    # > {data: {values: df, ...}}
+    # > {data: {url: 'url'}}
+    # > {data: {name: 'foo'}}
     if "data" in spec:
         data_spec = spec["data"]
 

streamlit/elements/widgets/audio_input.py

@@ -73,7 +73,7 @@ class AudioInputSerde:
         return state_proto
 
     def deserialize(
-        self, ui_value: FileUploaderStateProto | None, widget_id: str
+        self, ui_value: FileUploaderStateProto | None
     ) -> SomeUploadedAudioFile:
         upload_files = _get_upload_files(ui_value)
         if len(upload_files) == 0:

streamlit/elements/widgets/button.py

@@ -80,7 +80,7 @@ class ButtonSerde:
     def serialize(self, v: bool) -> bool:
         return bool(v)
 
-    def deserialize(self, ui_value: bool | None, widget_id: str = "") -> bool:
+    def deserialize(self, ui_value: bool | None) -> bool:
         return ui_value or False
 
 
@@ -799,15 +799,16 @@ class ButtonMixin:
     ) -> bool:
         key = to_key(key)
 
-        if on_click == "ignore" or on_click == "rerun":
-            on_click_callback = None
-        else:
-            on_click_callback = on_click
+        on_click_callback: WidgetCallback | None = (
+            None
+            if on_click is None or on_click in {"ignore", "rerun"}
+            else cast("WidgetCallback", on_click)
+        )
 
         check_widget_policies(
             self.dg,
             key,
-            on_click_callback,
+            on_change=on_click_callback,
             default_value=None,
             writes_allowed=False,
         )